home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / utilities / wb / dclock12.lha / DClock12 / DClock.doc < prev    next >
Encoding:
Text File  |  1994-11-01  |  5.1 KB  |  140 lines
  1.  
  2.     DClock V1.2        Copyright by Karl Lukas            01-Nov-1994
  3.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5.     #include <std/disclaimer.h>
  6.  
  7.  
  8.             Former users: See history below for changes.
  9.  
  10.  
  11.     Note:  This program is Freely Distributable, as opposed to Public
  12.     Domain.  Permission is given to  freely  distribute  this program
  13.     provided  no  fee  is charged, and  this  documentation  file  is
  14.     included with the program.
  15.  
  16.  
  17.     DClock makes use of the  reqtools.library,  which is not  part of
  18.     the distribution. It is available on Aminet or on the Amiga soft-
  19.     ware library (fish) disks.
  20.  
  21.  
  22.     DClock is a Digital Clock program for the Amiga. You need OS2.04+
  23.     for this program to work.  The installation is very easy:  Simply
  24.     drag the DClock icon to the WBStartup drawer.  DClock can also be
  25.     started with a doubleclick on it's icon or via the CLI.
  26.  
  27.  
  28.     If DClock  immediately returns after  startup, check  whether you
  29.     have
  30.            Kickstart V37+
  31.            reqtools.library V38+
  32.            a public screen called 'Workbench'
  33.            enough free memory
  34.  
  35.  
  36.     While the DClock window is active, you  can  chose  the following
  37.     menu items:
  38.  
  39.        Snapshot Position: Save the window's current position to
  40.                           ENVARC:DClock.prefs
  41.  
  42.        Foreground Color : Set the foreground (text) color
  43.  
  44.        Background Color : Set the background color (who would have
  45.                           guessed...)
  46.  
  47.        Seconds (toggle) : Display seconds on/off
  48.  
  49.        Alarm on (toggle): Turn alarm function on/off
  50.  
  51.        Timer on (toggle): Turn timer function on/off
  52.  
  53.        Set alarm clock  : Set the alarm time
  54.  
  55.        Set timer        : Set the timer
  56.  
  57.        Alarm command    : Enter a Shell-command which will be
  58.                           executed when the alarm went off.
  59.                           RUN your command if if it takes longer
  60.                           and you don't want to block out the GUI.
  61.  
  62.        Timer command    : dito for the timer.
  63.  
  64.        Dragbar (toggle) : Turn the window dragbar and title on
  65.                           and off. The state of the checkmark
  66.                           will be saved in the preferences file.
  67.                           YOU HAVE TO RESTART DCLOCK TO GET THE
  68.                           EFFEKT OF THIS.
  69.  
  70.        Save Preferences : Save all the settings to S:DClock.prefs
  71.  
  72.        About...         : Information about me ;)
  73.  
  74.        Quit             : Call the Terminator
  75.  
  76.  
  77.      When you select  `Save Preferences' or  `Snapshot Position' from
  78.      the Project menu,  the state  of the alarm  clock will be saved,
  79.      too. The alarm will then be automatically turned on after start-
  80.      up (if it was on when you saved the prefs, off course).
  81.  
  82.  
  83.      Send bug reports, compliments and such to
  84.  
  85.        kalle@gis.geogr.unizh.ch
  86.  
  87.      Send postcards, money and other gifts to
  88.  
  89.        Karl Lukas
  90.        Konradstr. 51
  91.        CH-8005 Zuerich/Switzerland
  92.  
  93.      Send threatening letters, letter bombs a.s.o. to
  94.  
  95.        NIL:
  96.  
  97.  
  98.      HISTORY
  99.      ================================================================
  100.  
  101.      V1.0 Apr 1994 o Initial release
  102.  
  103.      V1.1 Jun 1994 o DClock now runs three independent tasks:
  104.                      - User interface  (DClock)
  105.                      - Updating of the DClock window, timer etc.
  106.                        (DClockTask)
  107.                      - display information when alarm went off or
  108.                        timer is finished (DClockInfo).
  109.                      Advantage: Clock and timer won't be stopped tem-
  110.                      porarily while a window/requester is open. You
  111.                      can get informed now when the timer/alarm went
  112.                      off while a window/requester is open.
  113.  
  114.                    o Bug: The alarm and timer symbols were drawn with
  115.                      incorrect offsets, so that the display got mes-
  116.                      sed if big screen fonts were used.
  117.  
  118.                    o The settings are now stored in ENVARC:DClock.prefs
  119.                      You can copy your old DClock.prefs file from S: to
  120.                      ENVARC: if you want to use your old settings.
  121.  
  122.      V1.2 Nov 1994 o You can now enter a Shell command, which will be
  123.                      executed when the alarm or the timer went off. The
  124.                      command can be saved to the preferences file. If you
  125.                      don't want to execute a command, just enter an empty
  126.                      string.
  127.  
  128.                    o The current time is now displayed with two digits
  129.                      in the alarm/timer requester (i.e. 18:08:12 instead
  130.                      of 18:8:12). Hey, there is an ANSI function for
  131.                      this. Why didn't anybody tell me?  ;)
  132.  
  133.                    o You can now turn the titlebar and dragbar off with
  134.                      the menu option "Dragbar". Off course you cannot move
  135.                      the window anymore when the dragbar is turned off.
  136.                      You can save the state of the "Dragbar" menu item to
  137.                      the preferences. THIS ONLY TAKES EFFECT WHEN YOU QUIT
  138.                      AND START DCLOCK AGAIN.
  139.  
  140.